Класс MovieClip

Доступность

Flash Player 3.

Описание

Методы класса MovieClip предоставляют те же самые возможности, что и глобальные функции, параметрами которых являются мувиклипы. Также существует ряд дополнительных методов, аналогов которым на панели Actions toolbox панели Actions нет.

Вам не нужно использовать функцию конструктор, чтобы вызывать методы класса MovieClip; вместо этого, обращайтесь к мувиклипам по присвоенному им имени, как показано на примере:

my_mc.play();
my_mc.gotoAndPlay(3);

Вы можете расширять методы и обработчики событий класса MovieClip, создавая его подклассы. Для более подробной информации смотри "Присвоение класса мувиклип-символу " в Использовании ActionScript во Flash.

Обзор методов класса MovieClip

Метод

Описание

MovieClip.attachAudio()

Захватывает и проигрывает звук, поступающий с микрофона.

MovieClip.attachMovie()

Аттачит SWF ролик или мувиклип из Библиотеки.

MovieClip.createEmptyMovieClip()

Создает пустой мувиклип.

MovieClip.createTextField()

Создает пустое текстовое поле .

MovieClip.duplicateMovieClip()

Дублирует мувиклип .

MovieClip.getBounds()

Возвращает минимальные и максимальные координаты x и y мувиклипа в указанной системе координат.

MovieClip.getBytesLoaded()

Возвращает количество уже загруженных байт для указанного мувиклипа.

MovieClip.getBytesTotal()

Возвращает общий размер указанного ролика в байтах.

MovieClip.getDepth()

Возвращает глубину мувиклипа .

MovieClip.getInstanceAtDepth()

Возвращает ссылку на мувиклип на указанной глубине, если таковой существует.

MovieClip.getNextHighestDepth()

Возвращает номер следующей свободной глубины, которая может быть использована как параметр для других методов. Это позволяет быть уверенным в том, что Flash отобразит мувиклип перед всеми другими в текущем мувиклипе, а также что не произойдет замещения мувиклипов на одной глубине.

MovieClip.getSWFVersion()

Возвращает число, показывающее версию Flash Player, для которой мувиклип публиковался.

MovieClip.getTextSnapshot()

Возвращает объект класса TextSnapshot, содержащего информацию о статических текстовых полях в указанном мувиклипе.

MovieClip.getURL()

Открывает указанный URL.

MovieClip.globalToLocal()

Переводит координаты главного Таймлайна в локальные координаты мувиклипа.

MovieClip.gotoAndPlay()

Переводит воспроизводящую головку мувиклипа на указанный кадр и продолжает воспроизведение.

MovieClip.gotoAndStop()

Переводит воспроизводящую головку мувиклипа на указанный кадр и остонавливает воспроизведение.

MovieClip.hitTest()

Возвращает true, если ограничивающий прямоугольник данного мувиклипа пересекается с ограничивающим прямоугольником указанного мувиклипа.

MovieClip.loadMovie()

Загружает указанный SWF или JPEG файл в мувиклип.

MovieClip.loadVariables()

Загружает переменные с URL или из другого места на Таймлайн данного мувиклипа.

MovieClip.localToGlobal()

Переводит локальные координаты мувиклипа в координаты главного Таймлайна.

MovieClip.nextFrame()

Переводит воспроизводящую головку мувиклипа на следующий кадр.

MovieClip.play()

Проигрывает мувиклип .

MovieClip.prevFrame()

Переводит воспроизводящую головку мувиклипа на предыдущий кадр.

MovieClip.removeMovieClip()

Удаляет с Таймлайна мувиклип, созданный при помощи duplicateMovieClip(), MovieClip.duplicateMovieClip() или MovieClip.attachMovie().

MovieClip.setMask()

Делает мувиклип маской другого мувиклипа.

MovieClip.startDrag()

Начинает перетаскивание мувиклипа.

MovieClip.stop()

Останавливает воспроизведение мувиклипа .

MovieClip.stopDrag()

Останавливает перетаскивание всех перетаскиваемых в данный момент мувиклипов.

MovieClip.swapDepths()

Меняет глубины двух мувиклипов или переводит мувиклип на указанную глубину.

MovieClip.unloadMovie()

Выгружает мувиклип, загруженный при помощи MovieClip.loadMovie().

Обзор методов класса MovieClip, используемых для программного рисования

Метод

Описание

MovieClip.beginFill()

Начинает рисование заливки в указанном мувиклипе.

MovieClip.beginGradientFill()

Начинает рисование градиентной заливки в указанном мувиклипе.

MovieClip.clear()

Удаляет все программно нарисованные в данном мувиклипе элементы.

MovieClip.curveTo()

Рисует кривую, используя текущие настройки стиля линии.

MovieClip.endFill()

Заканчивает заливку, начатую MovieClip.beginFill() или MovieClip.beginGradientFill().

MovieClip.lineStyle()

Определяет вид линий, рисуемых при помощи MovieClip.lineTo() и MovieClip.curveTo().

MovieClip.lineTo()

Рисует линию, используя текущие настройки стиля линии.

MovieClip.moveTo()

Перемещает точку, из которой начинается рисование, в указанные координаты.

Обзор свойств класса MovieClip

Свойство

Описание

MovieClip._alpha

Уровень прозрачности мувиклипа.

MovieClip._currentframe

Только для чтения; номер кадра, в котором в данный момент находится воспроизводящая головка.

MovieClip._droptarget

Только для чтения; абсолютный путь в слэш-нотации к мувиклипу, на который перетаскиваемый мувиклип был "брошен".

MovieClip.enabled

Булева величина, показывающая, доступен или нет (enabled) мувиклип.

MovieClip.focusEnabled

Булева величина, показывающая, может ли мувиклип получать фокус.

MovieClip._focusrect

Булева величина, показывающая, отображается ли желтый прямоугольник вокруг мувиклипа, когда он находится в фокусе.

MovieClip._framesloaded

Только для чтения; число уже загруженных кадров в загружаемом SWF файле.

MovieClip._height

Высота мувиклипа в пикселах.

MovieClip.hitArea

Ссылка на мувиклип, служащая как "горячая зона" (hit area) для другого мувиклипа при проверке методом hitTest().

MovieClip._lockroot

Определяет, на что ссылается ключевое слово _root (на главный Таймлайн ролика-родителя или загруженного ролика) при загрузке SWF файла в мувиклип.

MovieClip.menu

Объект, связывающий объект класса ContextMenu с мувиклипом.

MovieClip._name

Имя экземпляра мувиклипа.

MovieClip._parent

Ссылка на мувиклип-родитель данного мувиклипа .

MovieClip._quality

Строка, отображающая качество рендеринга мувиклипа.

MovieClip._rotation

Угол поворота мувиклипа в градусах.

MovieClip._soundbuftime

Количество секунд буферизации перед воспроизведением потокового звука.

MovieClip.tabChildren

Булева величина, показывающая, включаются ли мувиклипы, вложенные в данный, в обход по клавише Tab.

MovieClip.tabEnabled

Булева величина, показывающая, включается ли мувиклип в обход по клавише Tab.

MovieClip.tabIndex

Порядковый номер мувиклипа в обходе по клавише Tab.

MovieClip._target

Только для чтения; путь к мувиклипу.

MovieClip._totalframes

Только для чтения; общее количество кадров в мувиклипе.

MovieClip.trackAsMenu

Булева величина, показывающая, получают ли все прочие мувиклипы, помимо данного, оповещение при отпускании левой кнопки мыши.

MovieClip._url

Только для чтения ; URL, с которого SWF файл, содержащий данный мувиклип, был загружен.

MovieClip.useHandCursor

Булева величина, определяющая, превращается ли курсор в изображение руки при наведении его на мувиклип.

MovieClip._visible

Булева величина, определяющая, скрыт или видим мувиклип.

MovieClip._width

Ширина мувиклипа в пикселах.

MovieClip._x

Координата x мувиклипа.

MovieClip._xmouse

Только для чтения ; координата x указателя мыши в системе координат мувиклипа.

MovieClip._xscale

Горизонтальный маштаб мувиклипа.

MovieClip._y

Координата y мувиклипа.

MovieClip._ymouse

Только для чтения; координата y указателя мыши в системе координат мувиклипа .

MovieClip._yscale

Вертикальный маштаб мувиклипа.

Обзор обработчиков событий класса MovieClip

Обработчик

Описание

MovieClip.onData

Вызывается при получении мувиклипом данных.

MovieClip.onDragOut

Вызывается, когда нажатие левой кнопки мыши произошло в пределах мувиклипа, а отпускание — за пределами .

MovieClip.onDragOver

Вызывается при перемещении курсора мыши (после прижатия левой кнопки) над мувиклипом.

MovieClip.onEnterFrame

Вызывается постоянно, частота зависит от частоты SWF файла в кадрах в секунду. Действия, связанные с событием enterFrame, выполняются после кода в кадрах.

MovieClip.onKeyDown

Вызывается при нажатии клавиши. Используйте методы Key.getCode() и Key.getAscii(), чтобы узнать, какая именно клавиша была нажата.

MovieClip.onKeyUp

Вызывается при отпускании клавиши.

MovieClip.onKillFocus

Вызывается при потере мувиклипом фокуса.

MovieClip.onLoad

Вызывается при появлении мувиклипа на Таймлайне.

MovieClip.onMouseDown

Вызывается при нажатии левой кнопки мыши.

MovieClip.onMouseMove

Вызывается при движении мыши.

MovieClip.onMouseUp

Вызывается при отпускании левой кнопки мыши.

MovieClip.onPress

Вызывается при нажатии левой кнопки мыши, когда курсор находится над мувиклипом.

MovieClip.onRelease

Вызывается при отпускании левой кнопки мыши, когда курсор находится над мувиклипом.

MovieClip.onReleaseOutside

Вызывается, когда нажатие левой кнопки произошло в пределах мувиклипа, а отпускание — вне.

MovieClip.onRollOut

Вызывается, когда курсор уходит с мувиклипа.

MovieClip.onRollOver

Вызывается при наведении курсора на мувиклип.

MovieClip.onSetFocus

Вызывается при получении фокуса мувиклипом, при отпускании клавиши.

MovieClip.onUnload

Вызывается при удалении мувиклипа с Таймлайна. Действия, связанные с этим событием, выполняются до кода в кадрах.